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Ablage von Pro jektinf ormationen in XML 

Die Ablage von Projektdaten einer Automatisierungskomponente 
erfolgt in XML . Dabei werden die Daten entweder direkt in 
diesem Format abgelegt oder entsprechende Export/ Import Funk- 
tionen bereitgestellt urn Projektdaten nach aufien im XML For- 
mat bereitzustellen. 

Durch dieses Vorgehen werden sind die Pro j ektdaten auiierhalb 
des Projekts in einem standardisierten Datenformat verfiigbar. 
Auf dieser Basis konnen externe Werkzeuge fur die vollstandi- 
ge oder teilweise weitere Verwertung oder Erzeugung von Pro- 
jektdaten eingebunden werden. 

Beispiele fur solche externe Werkzeuge sind: 

Versionsverwaltungstools wie ClearCase oder PVCS 

Externe CAD-Progr amine 

Externe Kurvenscheibenwerkzeuge 

Externe Productivity Tools die Teile von Projektdaten ge- 
nerieren konnen 

Externe Skripting Mechanismen urn die Erzeugung oder Dupli- 
zierung von Projektdaten zu unterstutzen 

Durch die Nutzung des Standardf ormats konnen kommerzielle 
Werkzeuge, die auf XML abbilden, genutzt werden. 
Dariiberhinaus konnen extern erzeugte auf XML basierenden Da- 
ten wie z.B. Maschinenbilder in das Projekt importiert wer- 
den . 

Auf Basis der genannten Mechanismen konnen z.B. Anderungen 
von Projekten durch Vergleich der Projektdaten im XML-Format 
sehr einfach erkannt und Unterschiede f einstgranular aufbe- 
reitet werden. Dies ist insbesondere fur FDA und dem hiermit 
notwendigen Change Control wichtig. 
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Einleitung 

Der Entwicklungsname von SIMOTION war UMC (Universal Motion 
Control) • Es stellt ein Basisautomatisierungssystem dar. Mit 
5 dieser Software ist es moglich durchgangige Automatisierungs- 
systeme fur Produktionsmaschinen zu erstellen (z.B. fur Ver- 
packungsmaschinen, Textilmaschinen, Pressen oder Kunststoff- 
maschinen) . Die Anf orderungen fur die SIMOTION- Software ba- 
sieren auf Erfahrungen mit anderen SIEMENS A&D - Produkten 

10 wie zum Beispiel SINUMERIK. Diese und andere Produkte des Be- 
reiches A&D erfullen schon heute die Anf orderungen an das Au- 
^ tomatisierungssystem. Aber die Gesamtlosung ist unzureichend 
und oft nicht wettbewerbsf ahig, was sich mit der SIMOTION- 
Software andern soil. Deswegen ist die Zielsetzung des 

15 SIMOTION, eine optimale Systemplattf orm fur Automatisierungs- 
losungen zu bieten. AuBerdem soil SIMOTION die Moglichkeit 
bieten, Maschinenablauf e (SPS) , spezifische Technologief unk- 
tionen und vor allem Motion Control - Funktionen zu program- 
mieren . 

20 

SIMOTION ist prinzipiell aus zwei Teilen aufgebaut. 

Das Runtimesystem von SIMOTION, das zu Entwicklungszeiten 
UMC- RT hiefi, ist auf drei verschiedenen Zielsystemen lauffa- 
hig: 

- Drive-based, 

- SPS-based und 

- PC-based. 

Es beinhaltet grundsatzlich ein Betriebssystem, Schnittstel- 
30 len zum Antrieb, Basisf unktionen ( wie Lageregler, Interpola- 
tor, Positionieren, Ref erenzieren, SPS-Funktionalitat ) und 
aufterdem Treiber fur den Feldbus PROFIBUS DP. Die Kommunika- 
tion des Gesamtsystems ist uber eine Standardkommunikation 
mit SIMATIC, PC und OVA gewahrleis tet . 
35 Technologief unktionen konnen mit Hilfe von Firmwarekomponen- 
ten hinzugeladen werden. Das Konf igurieren dieser Funktiona- 
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litat wird auf einem Erstellsystem vorgenommen und durch ei- 
nen Ladevorgang in das Zielsystem ubertragen. 

Das SIMOTION SCOUT hiefi wahrend der Entwicklung UMC- ES, was 
Erstell- bzw. Engineeringsystem bedeutete. 

Es kann als eigenstandiges System oder als System, das auf 
Step7 aufsetzt, genutzt werden. 

Das SIMOTION SCOUT enthalt eine Vielzahl von Funktionalitat : 

• Es ist moglich ein System oder eine Komponente zu konfigu- 
rieren, zu programmieren und zu projektieren . 

• Programmiertools fur das Runtimesystem sind im SIMOTION 
SCOUT enthalten. 

• Der Test und die Inbetriebnahme, sowie die Diagnose- und 
der Service kann durch die Software unterstiitzt werden. 

• SIMOTION SCOUT ist mit einer Bibliotheksf unktion fur Pro- 
gramme, Konf iguration (HW-, SW-Konf iguration) und Maschi- 
nen ausgestattet . 

• SIMOTION SCOUT kommuniziert mit dem Basis ES, das die Da- 
tenhaltung steuert und fur den Zugriff auf die Daten zu- 
standig ist. 

• Aufterdem gibt es die Moglichkeit des Teleservice, der 
Ferndiagnose und der Ob j ektverwaltung . 
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Abbildung 0. 1 : Das Universal Motion Control System 



Die SIMOTION- Software ist nach dem Three-Tier-Konzept aufge 
baut. Sie besitzt also eine grafische Oberflache, eine Verar 
beitungsschicht und eine Datenschicht . 
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Grundlagen 

Dieses Kapitel soli einen Einblick in die Grundlagen der 
Software geben. Aufierdem soil es alle im Export- Import- Me- 
chanismus verwendeten Begriffe und Techniken vermitteln. Es 
stellt aber keine vollstandige Dokumentation dar, deswegen 
verweise ich an geeigneter Stelle auf Referenzdokumente. 



10 



(a) Was ist ein Snap- In? 



15 



20 



30 



Allgemein versteht man unter einem Snap- In bei SIMOTION ein 
COM- Objekt. Die Workbench kann den Server in Form einer Dll 
laden und somit iiber die Schnittstellen des Servers auf Funk- 
tionen des Snap- Ins zugreifen. Die Kommunikation geht von 
einem Snap- In Host in der Workbench aus . 

Neue Snap- Ins werden mit der Workbench installiert, konnen 
aber auch spater hinzugefugt werden. Ebenso konnen Snap- Ins 
wieder entfernt werden. Wenn ein neues Snap- In hinzugefugt 
wird, legt es einen Registry- Eintrag an. Beim Starten der 
Workbench wird die Registry durchsucht. Neue Snap- Ins in- 
stalliert die Workbench automatisch. Durch diesen Aufbau ist 
es moglich durch neue Snap- Ins dynamisch Funktionalitat zu 
dem SIMOTION SCOUT hinzuzufugen und gegebenenf alls zu entfer- 
nen. Snap- Ins werden jedoch nicht sofort beim Start der 
Workbench geladen. Dies geschieht erst wenn eine Benutzterak- 
tion ein Snap- In anspricht. Das Benutzterkommando wird von 
der Workbench an das entsprechende Snap- In weitergeleitet . 



Benutzeraktion 



UMC- Workbench 




UMC- Workbench 



O- 



Snap In 
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Beim Laden eines Snap- Ins kann die Oberflache sowie die Me- 
nustruktur von SIMOTION SCOUT geandert werden. Es ist mog- 
lich, dass Toolbars eingefiigt werden und verschiedene Pro- 
jektteile eine neue Darstellung erhalten. 

Ein Snap- In muli bei SIMOTION bestimmten Anf orderungen genu- 
gen: 

- Da es ein COM- Objekt im herkommlichen Sinne ist, muli die 
IUnknown- Schnittstelle implementiert sein, wie COM es 
vorschreibt . 

- Fur die Kommunikation zwischen der Workbench und dem Snap- 
In muli die Schnittstelle IUMCSnapIn vorhanden sein. 

- Aufierdem mussen alle Snap- Ins unter der Kategorie „Snap- 
In of UMC-Workbench" in der Registry eingetragen sein, 

Wenn diese Anf orderungen erfullt sind, konnen noch optional 
neue Schnittstellen hinzugefugt werden. Diese Schnittstellen 
eignen sich, urn spezielle Aufgaben zu ubernehmen wie zum Bei- 
spiel Dateiverwaltung, Kommunikation mit anderen Snap- Ins 
oder grafische Schnittstellen. 
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Abbildung O.2.: Schnittstellen eines Snap- Ins 



(b) Anforderungen und Vorteile des Export- Import- Tools 



10 



Durch die Export- Import- Software soil es ermoglicht werden, 
dass die Daten eines SIMOTION- Projektes aus dem Basis ES in 
ein lesbares ASCII- Format exportiert werden konnen. Mit Hil- 
fe dieser exportierter Daten soli durch die Import- Funktion 
ein lauffahiges Projekt erzeugt werden konnen. 



15 



20 



Die exportierten Daten werden im XML- Format gespeichert. Da- 
bei wird unter den Teilkomponenten eines Projektes unter- 
schieden, indem sie in verschiedenen XML- Dateien beschrieben 
werden. Die bei dem Export entstandenen Dateien liegen in ei- 
ner Verzeichnisstruktur vor, die an den Aufbau des SIMOTION- 
Projektes angelehnt ist. An die Export- Import- Software des 
SIMOTION SCOUT werden folgende Anforderungen gestellt: 

- Die entstandenen Dateien sollen die Projektdaten mit Hilfe 
einer XSL- Datei in einer geordneten, tabellarischen Form 
im Internet- Explorer 5 anzeigen. 

- Exportierte XML- Dateien sollen bei der Diagnose eines 
Projektes hilfreich sein. Dies wird durch die Navigation 
liber das Projekt im Internet- Explorer erreicht. 
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- Weiterhin sollen durch einen modularen Aufbau des expor- 
tierten Projektes einzelne Teilkomponenten eines Projektes 
komf ortabel ausgetauscht und unabhangig von der Version 
der SIMOTION- Software in andere Projekte eingefugt werden 
konnen . 

- Durch einen strukturierten Aufbau der Dateien im Verzeich- 
nisbaum, soil die Archivierung und Erstellung von Versio- 
nen eines SIMOTION- Projektes vereinfacht werden. 

- Aufierdem kann man Dateien liber das Internet, per Email o- 
der uber FAX an dritte weiter zu geben. 

- Es ist prinzipiell moglich, dass der Benutzter mit Hilfe 
eines ASCII- Editor Daten des Projektes andern kann und 
diese durch den Import in das Projekt ubernehmen kann. Wo- 
bei die Anderung von Projektdaten normalerweise im Projekt 
in der Workbench vorgenommen werden sollte. 

(c) Einordnung des Exports und des Imports in die SIMOTION- Software 

Das in der Einleitung genannte Three-Tier-Konzept kommt auch 
in der Import- Export- Software zur Anwendung. 
Die grafische Benutzteroberf lache wird in der Workbench uber 
ein Snap- In angeboten. 

Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Er kann uber Schnittstellen auf die 
Daten des Basis ES lesend oder schreibend zugreifen. Uber ei- 
nen sogenannten Connection-Point werden die Ausgaben bei dem 
Export oder Import an das Snap- In in der Workbench gegeben. 
Die Daten werden mit Hilfe eines XML- Parser iibersetzt. Bei 
dem Export ist die Datenschicht das Basis ES, aus dem die Da- 
ten der XML- Files gewonnen werden. Bei dem Import ist dies 
umgekehrt. Die XML- Dateien werden ausgelesen und die Daten 
in das Basis ES geschrieben. 
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Workbench 




Abbildung O.3.: Kommunikation des Export- Import- Tools 



(d) Das XML- Format 

5 

XML (extensible Markup Language) 1st eine Metasprache fur das 
Definieren von Dokumenttypen . Es ist damit moglich, Dokumente 
zu erstellen, die alle den gleichen Grundmustern im Aufbau 
folgen. Auf der Grundlage dieser Dokumente konnen Programme 
10 leichter arbeiten. 
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Andere Vorteile von XML sind, dass die Daten strukturiert und 
hierarchisch beschrieben werden konnen. Aulierdem ist die 
Sprache Plattform unabhangig und einfach von Mensch und Ma- 
schine zu erzeugen. Ein entscheidender Aspekt fiir die Verwen- 
dung von XML ist, dass eine strickte Trennung zwischen In- 
halt, Darstellung und Struktur vorgenommen wird. 
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Abbildung 0.4. : Aufbau und Gliederung von XML 



(e) Unterschiede zwischen XML und HTML 

Warum die meisten Anbieter, Programmierer und Anwender von 
HTML auf XML umsteigen ist sehr einfach zu erklaren. Wahrend 
HTML eine Auszeichnungssprache ist, ist es mit XML moglich 
eine Auszeichnungssprache zu definieren. 

Vorteilhaft ist auch das Definieren eigener Tags. XML- Files 
konnen ganz bestimmte Tags enthalten und diese konnen wieder- 
um Tags enthalten. Dadurch kann ein XML- File einen Baum auf- 
bauen, der zu einer strukturierten Trennung verschiedener In- 
halte fiihrt. Damit ist die Grundlage fur eine maschinelle Be- 
arbeitung des Dokumentes gewahrleistet , die mit einem HTML- 
Dokument leider nicht gegeben ist. Ein grofter Unterschied 
zwischen HTML und XML ist die Trennung von Inhalt, Darstel- 
lung und Struktur. Nachteilig erscheint manchen Programmie- 
rer, dass er bei HTML sehr frei in seiner Formulierung ist, 
wahrend er bei XML auf die Wohlgef ormtheit eines Dokumentes 
achten muft (siehe Kapitel (f)). 

(f) Gultigkeit, Wohigeformtheit, validierende und nicht-validierende Parser 

Bei der Verarbeitung von XML- Dokumenten, wird zwischen zwei 
Instanzen unterschieden : dem XML- Parser und der Anwendung. 
Der Parser verrichtet seine Arbeit im Sinne einer Anwendung 
und ist in den meisten Fallen ein Browser. Es kann mit zwei 
verschiedenen Parsern gearbeitet werden, mit dem DOM- oder 
dem SAX- Parser. Der DOM- Parser erstellt einen XML- Baum und 
der SAX- Parser ist ereignisorientiert . Diese beiden Parser 
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werden im Kapitel 0 naher erklart. Alle Parser sollten jedoch 
diese Eigenschaf ten erftillen: 

- Ein Parser pruft ein XML- Dokument auf Wohlgef ormtheit und 
gibt gegebenenf alls Fehler aus. 

5 - Wenn das Dokument aus mehreren Bestandteilen aufgebaut 
ist, werden diese zusammen geftigt. 

- AuBerdem wird ein Baum erstellt, durch den die Anwendung 
auf die Inhalte der Tags zugreifen kann. 

10 Wenn ein Dokument auf Gtiltigkeit untersucht wird, vergleicht 

der Parser das Dokument mit der DTD. Da dieser Vergleich sehr 
^ umfangreich ist, wurde das Konzept der Wohlgef ormtheit einge- 
') fiihrt. Bei diesem Konzept wird lediglich sichergestellt , dass 
^ die Erstellung des Baumes moglich ist. 



Grundsatzlich ist ein Dokument wohlgeformt, wenn es folgende 
sechs Eigenschaf ten besitzt: 

1. Jedes XML- Dokument muJ5 mit einer Deklaration beginnen. 
Wie zum Beispiel: <?XML version = *1.0* ?>. 
20 2. Alle Elemente mtissen ein Ende- Tag besitzen: 

<title> Der Export - Import - Mechanismus des SIMOTION 
SCOUT </title> 

Ebenso mtissen leere Elemente wie <BR> ein Ende- Tag besit- 
zen: 

j|5 Entweder <BR/> oder <BR> </BR>. 

3. Alle Elemente sind case-sensitive, das heiii zwischen 
Grofi- und Kleinschreibung wird unterschieden. 

4. Alle Attributwerte sind in Hochkommas zu setzen. 

5. Ein sauberes Verschachteln der Tags ineinander mufi gewahr- 
30 leistet sein. Das heii3t untergeordnete Tags mussen ge- 

schlossen werden bevor ubergeordnete Tags geschlossen wer- 
den . 

6. Ein Element muli als eine Art Container alle anderen Ele- 
mente einbetten. 




15 



35 



Seite 13 von 56 



200023311 



14 



Da bei der Priifung auf Wohlgef ormtheit kein Abgleich mit der 
DTD statt findet, ist ein wohlgef ormtes XML- Dokument nicht 
unbedingt giiltig. 
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Abbildung O.5.: Unterscheidung Wohlgeformtheit und GOltigkeit eines XML- Dokuments 



Aus diesen Grunden kommen zwei verschiedene Parser zur Anwen- 
5 dung. Ein validierender Parser prtlft auf Giiltigkeit, ein 
nicht validierender Parser prtlft auf Wohlgeformtheit eines 
XML- Dokuments. Wenn auf die Giiltigkeit eines Dokumentes ge- 
pruft wird, ist die Prufung auf Wohlgeformtheit eingeschlos- 
sen . 

(g) Die Stylesheets (XSL) 

XSL (extensible Stylesheet Language) ist eine Beschreibungs- 
sprache der Darstellung eines XML- Dokumentes. Mit Hilfe ver- 
schiedener XSL- Dateien konnen XML- Dokumente andere Darstel- 

15 lungen annehmen. 

Bei HTML wird die Darstellung mit cascading Stylesheet Langu- 
age (CSS) beschrieben. Diese Beschreibungsart kann ebenso in 
XML- Dokumenten eingesetzt werden, jedoch gibt es bei XSL ei- 
nige Vorteile gegeniiber CSS. XSL ist eine Programmiersprache 

20 im herkommlichen Sinne, das heiflt IF- Abfragen und Speiche- 
rung von Werten in Variablen konnen gesetzt werden. Einzelne 
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Komponenten konnen genommen werden und an anderen Platzen 
auftauchen, wie zum Beispiel in der Kopf- oder Fufizeile. Da 
XSL nicht an die Sprachen der westlichen Welt angepasst ist 
und damit nicht ausschlieiilich horizontale Schrif tzeichen 
dargestellt werden konnen, ist es global verwendbar. 
Damit ein XML- Dokument eine XSL- Datei zur Darstellung he- 
ranzieht, mufi diese am Anfang des XML- Dokumentes bekannt ge- 
macht werden. 
Zum Beispiel: 

<?xml- stylesheet type=" text/xsl" href ="unic . xsl" ?> 

(h) Die Struktur einer XML- Seite (DTD) 

In einer DTD (Documenttype- Definition) wird die Struktur und 
die Gliederung eines XML- Dokumentes festgelegt. Alle in ei- 
nem XML- Dokument verwendeten Elemente miissen in der zugeho- 
rigen DTD beschrieben werden. Weiterhin . mufi in der DTD fest- 
gelegt werden, wie die Elemente verschachtelt sind und welche 
Werte die Attribute annehmen konnen. 

Durch die Festlegung der Regeln fur XML- Dokumente in einer 
DTD, ist es moglich einer Anwendung das Auslesen und die Ver- 
arbeitung der Daten zu uberlassen. 

DTD konnen in einer separaten Datei untergebracht werden (ex- 
terne DTD) . Anderenfalls kann die DTD am Anfang des XML- Do- 
kumentes stehen, wobei sie hier interne DTD genannt wird. 
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Ein Ordner besteht sus rnindestens einem Buch 

<! ELEMENT ordner (book)+ > 

Dsr Ordner hat ais Pftchattribut die ID — — 

< ! ATTL I ST ordner id ID #REQUIRED > 

Ein Buch besitzt eineii Titel, mindesteru? einsn Autar und wurde durch tmtn Verlag veroffentlicht 



< ! ELEMENT 



book 



< ! ATTL I ST book 

Em Titei besteht aus einem String 
<! ELEMENT title 



< ! ELEMENT 
< ! ELEMENT 



author 
publisher 



( title, author*, puplisher ) > 
isbn CDATA #REQUIRED> 
( #PCDATA )> 
(#PCDATA)> 
(#PCDATA)> 



Abbildung 0.6. : Beispiel fur eine DTD 
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Das Snap- In in der Workbench 

Das Snap- In des XML- Tools ist ein mittels ATL geschriebener 
COM- Server, der eine Schnittstelle zwischen dem Benutzer und 
dem XML- Server darstellt. Durch bestimmte Benut zeraktionen 
kann das Snap- In geladen werden. Uber die grafische Oberfla- 
che kann der Benutzer den Export und den Import bedienen. Die 
Kommunikation zwischen Snap- In und Workbench wird uber ver- 
schiedene Schnittstellen des Snap- Ins ermoglicht . 

(i) Das GUI des Snap- Ins 

Dieses Kapitel beschreibt die grafische Oberflache, die das 
Snap- In zur Verfligung stellt, und dessen Bedienung zum Ex- 
oder Import von Pro j ektdaten . 

(j) Starten des Ex- oder Imports 

Das Snap- In wird beim Klicken auf den entsprechenden Button 
oder beim Auswahlen des Exports oder Imports im Menu „Datei* 
geladen. 
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Abbildung 0.1.: Laden des Snap- Ins durch Benutzeraktionen 

(k) Der Export eines Projektes 



Der Export eines Projektes ist natiirlich nur moglich, wenn 
ein Projekt geoffnet ist, Nach dem des Exports wird das Snap- 
In geladen und es erscheint dieser Dialog: 
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Projekt Export 



? -Export Emstellungert-- - - ' : — — ' - - - • 

' Geben sie Ziefpfad tmd 2ielriamen des Exports an' ' \ 

1 -i 




Abbildung 0.2. : Der Exportdialog 

Der Projektpfad beschreibt das Verzeichnis, in dem die expor- 
tierten Daten gespeichert werden sollen. Man kann im Dialog 
einen Ordner angeben, der das exportierte Projekt beinhalten 
soil. Durch den „Ordner- Button* kann der Ordner aus dem Ver- 
zeichnisbaum ausgewahlt werden. 
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Abbildung 0.3.: W&hlen eines Verzeichnisses ffir das zu exportierende Projekt 



Dabei ist zu beachten, dass alle im Ordner vorhandenen Datei- 
en zu Beginn des Exports geloscht werden. Mit dem OK- Button 
wird letztendlich der Export gestartet. 
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(I) Der Import eines Projektes 

Der Import hat zwei Moglichkeiten ein Projekt zu importieren. 
Zum Einem konnen die Daten in ein bestehendes Projekt einge- 
fugt werden. Dazu mufi der Import gestartet werden, wenn ein 
Projekt geoffnet ist. Der Benutzer wird vor dem Import ge- 
fragt, ob er das Projekt andern will. Wenn der Import in ein 
bestehendes Projekt durchgefuhrt wird, werden neue Daten ein- 
gefugt, Daten, die im zu importierenden Projekt sowie im be- 
stehenden Projekt vorkommen, durch die import ierten Daten ak- 
tualisiert und bestehende Daten beibehalten. 

Zum Anderen kann beim Import ein neues Projekt angelegt wer- 
den. In diesem Fall mufi der Import gestartet werden, wenn 
kein Projekt geoffnet ist. Das importierte Projekt ist nach 
dem Import mit dem exportierten Projekt identisch. 
Der Import blendet einen ahnlichen Dialog auf wie der Export. 
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Projekt Import 



-Import Einstellungen — — — — 
\ Ort der XML Projekt Dateien: 



C \Pr o q r a rn m e\S i e rn e ns\Ste p ?\S 7 p r o j ; 




I OK 



Abbrecrmn- j Help | 



Abbildung 0.4. : Der Importdialog 



Der Zielpfad zeigt auf das neu angelegte Projekt oder auf das 
Projekt, in das importiert werden soil. Hier ist ebenfalls 
der Projektpfad angegeben, in dem das Projekt importiert 
wird. Es sollte in diesem Dialog eine XML- Datei ausgewahlt 
werden, die die Wurzel des zu importierenden Projektes ist. 
Diese XML- Datei kann durch einen File- Dialog ausgewahlt 
werden, der durch den „0rdner- Button* angezeigt wird. 



|wahlen sie das entsp recti ende XML-Fi 


le qus: 


E1E3 


S^SlimSS^ ^ testl 
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DaleinQmeV |projekt.xml 




Offnen J 


Dateityp- jXML-Dateien (*jcml) 




_ _ izj Abbrechen 



Abbildung 0.5.: Wahlen einer XML- Datei fur den Import 

(m)Die Statusausgabe des Ex- bzw. Imports 

Der Status des Exports oder des Imports wird jeweils in einem 
Ausgabef enster dokumentiert . Dort wird der Benutzer auf Feh- 
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ler, die rot hervorgehoben sind, aufmerksam gemacht, die Be- 
endigung des Exports oder Imports ausgegeben und ein Link zu 
den XML- Dateien anzeigt. 
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Oer Export der Projektdaten wurde gestartet 
Brtte Warten... 

Einetiegspunkt fur das Betrachten der Daten im Internet Explorer (Version 5): 
filQA\Q;Vest1\aqw e sflw e ,ht m l 



OrtderexportiertenXML-Daten: 
D:\test1 \ 

Der Export der Projektdaten wurde beendet 



Driven Ste Pi ; urn HiCeiu erhoiten. 



Abbildung 0.6. : Statu sausgabe des Ex- oder Imports 



10 



Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Dies ist ein COM- Server, der das 
Auslesen und Ubersetzten der Daten ubernimmt . Bei dem Export 
ist die Datenschicht das Basis ES, aus dem die Daten der XML- 
Files gewonnen werden. Bei dem Import ist dies umgekehrt. Die 
XML- Dateien werden ausgelesen und die Daten ins Basis ES ge- 
schrieben . 



(n) Die Interfaces des Snap- Ins 

Die Schnittstellen eines Snap- Ins ermoglichen die Kommunika- 
15 tion zwischen der Workbench und dem Server des Snap- Ins. Ein 
Snap- In muft die Schnittstelle IUMCSnapIn implementieren, urn 
als Snap- In erkannt zu werden. Die Schnittstellen IUMCHelp 
und IUMCSnapInProperties beinhalten verschiedene Funktionen, 
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die ein Snap- In verwenden kann. Natlirlich konnen andere 
Snap- Ins diese Schnittstellen implementieren . Deswegen gehe 
ich auf diese Schnittstellen nur kurz ein und schenke der 
speziellen Schnittstelle des XML- Servers (IXMLStatus) mehr 
Aufmer ksamkeit . 
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IUnknown m_J 

^^llllllllllllllll: 

IUMCSnapIn 




DCMLStatus 
IUMCSnapInProperties ^j) 


y 



Abbildung O.7.: Schnittstellen des XML- Snap- Ins 

(o) IUMCSnapIn 

5 Die Schnittstelle IUMCSnapIn ist die obligatorische Schnitt- 
stelle fur Snap- Ins wie die IUnknown Schnittstelle von COM. 
Jedes Snap- In mufi diese Schnittstelle implementieren wobei 

^ es unerheblich ist, ob das Snap- In eine grafische Oberflache 
besitzt oder nicht. Weiterf uhrendes Dokument zu diesem Inter- 

10 face ist unter 

Werlf452a\umc all$\doc\Icd\ICD SnapInMCD Snapln SnapInHost. 
doc zu finden. 

(p) lUMCHelp 

15 Um eine Hilfe zu einem Snap- In zu erhalten, ist es moglich 
mit Fl eine Hilfedatei zu offnen. Diese Funktionalitat wird 
durch das Interface lUMCHelp zur Verfiigung gestellt. Zu die- 
ser Schnittstelle ist eine Dokument at ion unter 
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Werlf 4 52a\umc all$\Systenitest\Engineering SystemX Infos \Kochb 
uch ESXKochbuch ES.doc vorhanden. 

(q) lUMCSnaplnProperties 

Dieses Interface ubermittelt der Workbench die Eigenschaf ten 
des Snap- Ins. Das ist notig, da die Workbench sehr allgemein 
gehalten ist und keine spezifischen Daten des Snap- Ins 
kennt. Wenn ein Snap- In diese Schnittstelle implementiert , 
kann eine bestimmte Darstellung erreicht werden. Auiierdem 
konnen Anderungen wahrend der Laufzeit der Workbench tibermit- 
telt werden. Die Schnittstelle lUMCSnaplnProperties ist in 
dem Designdokument 

Werlf 452a\umc all$\doc\Icd\ICD SnapInMCD Snapln Properties, 
doc naher beschrieben. 

(r) IXMLStatus 

Diese Schnittstelle ermoglicht das Konvertieren eines Devi- 
ces, wobei der Typ des Devices verandert wird. Die Konvertie- 
rung erfolgt durch das Exportieren der Devicedaten und an- 
schlieliendes Importieren der Devicedaten. Damit hat diese 
Schnittstelle mit dem eigentlichen Export und Import eines 
Projektes nichts zu tun, verwendet aber einen ahnlichen Me- 
chanismus, urn ein Device zu konvertieren. 

Die Schnittstelle besitzt zwei Funktionen: ExportAndConvertE- 
SObject und ImportESObj ect . ExportAndConvertESObj ect expor- 
tiert und konvertiert, wie der Name schon sagt, ein Device. 
Dieser Methode muli eine DevicelD, eine TypelD und ein Ziel- 
verzeichnis ubergeben werden. Wenn das Device exportiert 
wird, 
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wird die alte TypelD durch die iibergebene ersetzt. Alle Dia- 
loge und Benut zeraktionen werden vernachlassigt , da der Ex- 
port nur intern iiti Programm durchgefiihrt wird. Den eigentli- 
chen Export eines Devices ubernimmt der XML- Server, auf den 
ich im Kapitel 0 naher eingehen werde. Da in diesem Fall nur 
ein Teil des Projektes exportiert werden soil, wird eine Mas- 
ke gesetzt, die das spezif iziert . Die Funktion ExportAndCon- 
vertESObject liefert nach erf olgreichem Export ein String des 
XML- Dateinamens zurilck. 

Die Methode ImportESObj ect import iert das Device und erhalt 
den Ordner, der die exportierten Dateien enthalt, und die 
XML- Datei, die bei ExportAndConvertESObject zuriickgelief ert 
wurde. Bei dem Import ist es ebenso nicht notwendig die Dia- 
loge anzuzeigen, da es sich wie beim Export urn einen internen 
Import handelt. Nun importiert der XML- Server das Device auf 
Grund der ubergebenen XML- Datei und gibt die DevicelD an die 
aufrufende Funktion zuriick. 
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Der XML- Server 

Der XML- Server ist ein ATL- Server und fuhrt den eigentli- 
5 chen Ex- oder Import der Daten durch. In diesem Kapitel werde 
ich auf die Funktionsweise und den Aufbau des Servers einge- 
hen . 

Die Dll wird in das Programm geladen, wenn die Schnittstelle 
des Servers angesprochen wird. Die Schnittstelle heiiit IXML- 

10 Server und bieten zwei Methoden an. Mittels dieser Methoden 
wird der Import und der Export angestofien, deswegen heiften 
sie Startlmport und StartExport. Diese Funktionen sind die 
einzigen Funktionen, die von Auflen aufgerufen werden konnen, 
denn wie aus dem Bild ersichtlich stehen keine weiteren 

15 Schnittstellen zur Verfugung. 



Abbildung 0.1.: Schnittstellen des XMLServers 

(s) Der Export 

2 0 (t) Der DOM-Parser 

Der Export arbeitet mit dem Xerces Parser von Apache. Dieser 
Parser ist ein DOM- Parser, der sich dadurch auszeichnet, 
dass er einen XML- Baum aufbauen kann. Die Funktionalitat des 
25 Parsers wird in verschiedenen Headerdateien beschreiben. 
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Durch das Einfligen dieser Dateien im Projekt stehen die Funk- 
tionen des DOM- Parsers zur Verfugung. 

Die Klassen DOM_Node, DOM_Document und DOM_Element sind die 
wichtigsten Klassen des DOM- Parsers. Ein XML- File wird 
durch die Klasse DOM_Document reprasentiert . Ein Tag oder E- 
lement eines XML- Files wird durch ein DOM_Element reali- 
siert, die in einem DOM__Document eingefiigt werden konnen. Au- 
fierdem wird durch die Klassen DOM__Attr , DOM_Entity, DOM_Text 
und DOM^Comment weitere Funktionalitat zur Verfugung ge- 
stellt, urn einen Baum aufzubauen und ein XML- File zu erstel- 
len. Fortfuhrende Dokumentation zu dem DOM- Parser von Apache 
ist im Internet unter www . apache . de und 

www .w3.org/TR/ 1998 /REC-DOM-Level-1- 19981 001/level-one- 
core.html zu finden. 

Der Aufbau des XML- Baumes wird durch den Aufruf verschiede- 
ner Funktionen des DOM- Parsers erreicht. Deswegen beinhaltet 
die Klasse CDomHelper die Grundf unktionalitat , urn die XML- 
Files zu erstellen. 

Ein wichtiger Member der Klasse ist die Instanz der Klasse 
DOM_Document, die eine XML- Datei erzeugt, und eine Instanz 
der Klasse DOM_Element, die das Roottag speichert. 
Wie aus dem Code ersichtlich, sind verschiedene Funktionen 
zum Beschreiben eines XML- Files vorhanden, wie writeDomDoc, 
writeDTD und writeXSL. Sie sind private Funktionen der Basis- 
klasse CDomHelper und werden am Ende des Exports einer Daten- 
menge aufgerufen. Somit wird eine XML- Datei erst nach dem 
vollstandigen Export geschrieben, urn keine inkonsistenten Da- 
ten in der Datei zu erhalten und damit die Fehlerbehandlung 
erleichtert wird. Das heifit, wenn ein Fehler beim Exportieren 
von Daten auftritt, konnen die fehlerhaften Daten verworfen 
werden, ohne das eine Datei von der Festplatte geloscht wer- 
den mufi . 

AuBerdem ist es moglich mit den Funktionen openDomHelper und 
closeDomHelper Vorinitialisierungen bzw. das abschlieflende 
Schreiben der XML- Datei durchzuf uhren . Die Funktion openDom- 
Helper initialisiert die Membervariablen mit gultigen Werten 



Seite 30 von 56 



200023311 



31 



und legt ein DOM_Document mit einem DOM_Element an, das den 
Namen des ubergebenen Strings besitzt. In der Methode close- 
DomHelper werden die oben genannten Funktionen zum Schreiben 
des XML- Files aufgerufen. 
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Urn XLinks zu erstellen und neue Verzeichnisse anzulegen, ste- 
hen die Funktionen createSubDir, setXLink und setFullXLink 
zur Verfugung. 

Die Funktionen writeDTD und ManageNavigation sind reine vir- 
tuelle Funktionen und mussen von alien Klassen, die von der 
Klasse CDomHelper abgeleitet sind, implementiert werden. 



class CDomHelper 
{ 

public : 

CDomHelper ( ) ; 

vi rtual -CDomHelper ( ) ; 



DOM_Document *getDomDoc ( ) 
DOM_Element *getDomRootNode ( ) 

of stream *getOS ( ) 



{ return &m_domDoc; ) ; 

{ return &m_domRootElement ; } ; 

{ return &m_OS;}; 



/////////////////////////// 
// Static Members 
static CExport *m_pExport; 
static bool m bSwitchXSL; 



protected: 

of stream 
of stream 
DOM_ Document 
DOM_Element 
bool 



m_OS; 
m_XSL_OS; 
m_domDoc; 
m_dornRoo tEl ement ; 
m DTD Check; 



virtual void 
virtual void 
virtual H RESULT 

Quellcode 0.1.: Klassendefinition der Klasse CDomHelper 



writeDTD ( ) = 0; 

writeXSL{ ) ; 

ManageNavigation ( ) = 0; 
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Wenn man nun bestimmte Daten eines Projektes exportieren 
mochte, wird eine eigene Klasse von der Klasse CDomHelper so- 
wie von der Klasse CBasisEsHelper abgeleitet* Die Klasse CBa- 
sisEsHelper 1st wichtig, urn an den Pointer auf die entspre- 
chende Schnittstelle im Basis ES leichter zu gelangen, und 
wird im Kapitel (q) eingehend beschrieben. 

Bei dem Export eines Projektes werden zwei verschiedene Arten 
von XML- Dateien erstellt. Es konnen Dateien als „Linkdatei- 
en* fungieren sowie als „Datendateien* . Die „Linkdateien* 
beinhalten keinerlei Daten, sondern nur Links zu „Datendatei- 
en* und „Linkdateien* , die in einem Unterverzeichnis liegen 
(siehe Kapitel 0) . 

Um eine „Datendatei* zu erstellen, wird die von den beiden 
oben genannten Klassen abgeleitete Klasse benotigt, die ein 
neues XML- Dokument anlegt und dies mit den zu exportierenden 
Daten fullt. Diese Daten sollten moglichst eine abgeschlosse- 
ne Datenmenge bilden. 

Diese Klasse muft die Funktion Mana geNavigati on, . wie in den 
folgenden Abschnitten erlautert, uberschreiben • 
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Die Funktion ManageNavigation ist der Einstieg in die Klasse. 
Hier soil dafur gesorgt werden, dass ein XML- Dokument ange- 
legt wird, die Daten exportiert werden und das XML- File mit 
5 den exportierten Daten beschrieben wird. 

Das Anlegen der XML- Datei wird, wie oben beschrieben, durch 
die Funktion openDomHelper angestofien. Danach ist die Member- 
variable m^domRootElement auf einen gliltigen Wert gesetzt, an 
die man nun weitere Elemente anfugen und somit den XML- Baum 

10 aufbauen kann. 

Fur das Exportieren einzelner Daten ist es moglich, eigene 
Funktionen zu erstellen und diese dann in der Methode Manage- 
Navigation aufzurufen. Dabei kann man die Daten zum Einen di- 
rekt an das Rootelement, das wie gesagt in der Variable 

15 m_domRoot Element gespeichert ist, anhangen oder sie anderen 

Falls unter ein neu erstelltes Element hangen, je nach Struk- 
tur der Daten im Basis ES - Das heifit, das die Funktionen den 
ubergeordneten Knoten als Auf ruf sparameter erhalten und sie 
sich ebenso tief wie die Elemente im XLM- Baum schachteln 

2 0 konnen. 

Wenn alle Daten aus dem Basis ES gelesen wurden und keine 
Fehler auftraten, wird die Funktion closeDomHelper aufgerufen 
und somit die XML- Datei mit den Daten gefullt. 

^|jp Eine „Linkdatei* wird durch eine prinzipiell genauso aufge- 

baute Klasse erstellt. Die Funktion ManageNavigation ruft die 
Methoden openDomHelper und closeDomHelper auf, um die XML- 
Datei zu erstellen. Pro Link kann man eine Funktion anlegen, 
die in der Methode ManageNavigation aufgerufen wird. Diese 
30 Funktionen sollte einen XLink zu der entsprechenden Datei an- 
legen, eine Instanz der Klasse anlegen, die den Export der 
Daten durchfuhrt, und deren ManageNavigation Funktion aufru- 
f en . 

35 Die DTD eines XML- Files wird mit der Funktion writeDTD er- 
stellt, die wie schon erwahnt iiberschrieben werden muft . Fur 
die DTD wird am Beginn des XML- Files ein String eingefugt, 
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in dem ein Makro an die dafiir vorgesehene Membervariable an- 
gehangt wird. Dafiir stehen die Dateien DTDHelper.h und DTDOb- 
jectDefs . h zur Verfiigung. In der Datei DTDHelper.h sind ver- 
schiedene Makros definiert, die das Erstellen einer DTD ver- 
einfachen sollen. In der DTDObj ectDefs . h muB nur noch ein 
spezielles Makro fur den DTD- String definiert werden, das 
dann in der Methode writeDTD verwendet wird. 
Die XSL- Definitionen werden ahnlich erstellt und sind fur 
die Daten wichtig, die in Internet- Explorer angezeigt werden 
sollen. Auch hier existieren zwei Haederdateien XSLDefs .h und 
XSLDefsHelper.h, die Strings fur die XSL- Files definieren. 
In der XSLDefsHelper.h sind Makros definiert, die das Erstel- 
len der XSL- Datei erleichtern. Die Makros fur die jeweilige 
XML- Datei werden in der XSLDefs. h Datei eingefugt. Es mufl 
darauf geachtet werden, dass die neue XSL- Definition an ent- 
sprechender Stelle in eine andere eingefugt wird, wenn fur 
die XML- Datei kein eigener Ordner angelegt wird und sie sich 
mit anderen XML- Files eine XSL- Datei teilen mufi . Eine eige- 
ne XSL- Datei wird nur von den Klassen, die eine „Linkdatei* 
erstellen, durch die Funktion writeXSL angelegt . 

(u) Navigation uber ein Projekt 

Fur die Beschaffung der Pointer auf die Schnittstelle, die 
fur den Export angesprochen werden muB, stehen den Klassen 
der Export- Import- Software die Klasse CBasisEsHelper zur 
Verfiigung. 
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class CBasisEsHelper 
{ 

public : 

// Konstruct / Destruct 
CBasisEsHelper ( ) ; 
virtual -CBasisEsHelper () ; 

//static Basemembers 
public : 

static CComPtr<IMC_Proj ect> m_pProject; 

static CComPtr<IMC_Device> m_pDevice; 

static CComPtr<IMC_Ident> m_pTO; 

static CComPtr<IMC_Program> m_pProgram; 

static CXMLServer* m_pXMLServer ; 

static CComPtr<IUMCWBObjectSetHandler> m_pObj ectSetHandler; 

static long m_10bj ectSetHandle; // Handle auf das Objectset 

static CComPtr<IUMCSnapInHost> m_pSIH; 
static CComPtr<IUMCSnapIn> m_pSI; 

static UMC_PROJECTMODE m_Proj ectMode; 

static std: : map<_bst r_t, _bstr_t> m_bst rChangedDeviceNameList; 

static IsNameMapEntry+m_pTOMap; 

static long m_nTOMapSi ze; 

static unsigned long m_Export Filter ; 

Quell code 0.2. : Klassendefinition der Klasse CBasisEsHelper 
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Diese Klasse besitzt einige Variablen, die auf wichtige 
Schnittstellen zeigen. Von ihnen aus konnen andere Interfaces 
angesprochen werden. Dariiber sind die benotigten Schnittstel- 
len zu finden. Die wichtigsten Inter facepointer sind zu den 
Schnittstellen IMC_Project, IMC_Device, IMC_Ident und 
IMC__Program. Auflerdem gibt es noch Pointer zum Snap- In, zum 
Snap- In- Host und zum XMLServer fur die Ausgaben beim Im- 
und Export. Um die Daten bearbeiten zu konnen, mussen sie an 
ein sogenanntes „ObjectSet* der Schnittstelle IUMCWBObj ect- 
SetHandler gebunden werden. Auf dieses Interface zeigt die 
Memb ervariable m_pObj ectSetHandler . 
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Neben den Variablen sind verschiedene Funktionen definiert. 
Daten, die in ein XML- File geschrieben werden, iruissen in 
Strings vorliegen. Deswegen sind in der Klasse CBasisEsHelper 
mehrere Methoden zum Konvertieren von Daten in Strings und 
umgekehrt vorhanden. Fur das „Ob j ectSet* sind verschiedene 
Funktionen definiert, die Objekte dem ^ObjectSet^ hinzufugen 
und entfernen konnen. 



10 



15 



Die Daten eines Projektes sind unter verschiedenen Schnitt- 
stellen abgelegt. Urn an ein Interface zu gelangen, das die 
gewiinschten Daten enthalt, ist es manchmal notwendig iiber 
verschiedene andere Schnittstellen zu navigieren. Fiir das im 
Kapitel (c) beschriebene Beispiel, war es notig iiber zwei 
weitere Schnittstellen das Interface anzufordern. Wie aus der 
Abbildung 0.2 ersichtlich, ist es moglich die Schnittstellen 
durch Aufrufen von Querylnterface und getObj ectBylD zu erhal- 
ten. 



o 



Qu e ryln t erf a c e 



IMC_Project 



gre t Ob j e c t By ID 



Qu eryln t erf a ce 



IMC Ident 



IMC_Project 
Navigate 



IMC_Alarms_ 
S_Navigate 



20 



Abbildung 0.2.: Navigieren zu den Interface fur den Export der Alarme 



Eine Dokumentation iiber die Schnittstellen des Basis ES und 
eine Beschreibung, wie verschiedene Interfaces angesprochen 
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werden, ist unter 

Werlf 452a\umc all$\doc\ICD\icd basis es.doc vorhanden. 
(v) Ein Beispiel fur den Export - exportieren von Alarmen 

5 Urn die Funktionsweise und den Aufbau des Exports verstandli- 
cher zu machen, erlautere ich den Export am Beispiel des Ex- 
ports von Alarmdaten. 

Die Stelle, an der das Programm erweitert werden mufl, ist ab- 
hangig von den Daten, die exportiert werden sollen, da der 
10 Export die Dateien in einer Verzeichnishierarchie ablegt, die 
der Hierarchie des Projektes im SIMOTION SCOUT- Programm ahn- 
(1^. lich ist (siehe Kapitel 0) . Die Alarme sind pro j ektglobal, 
deswegen sind sie auf der ersten Ebene zu exportieren. 

15 Da die Alarme nicht von anderen Daten im Projekt abhangig 
sind, legt der Export fur diese Daten eine neue XML- Datei 
an. Deswegen ist es vorteilhaft fur den Export der Alarme ei- 
ne neue Klasse anzulegen. Diese Klasse heiflt CAlarmNavigati- 
on. Sie besitzt alle Eigenschaf ten, die eine „Navigation- 

20 Klasse* hat und ist wie folgt aufgebaut. 
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class CAlarmNavigation : 

public CBasisEsHelper, 
public CDomHelper 

{ 



public : 



//= 



//Const ruction/ Destruction 



CAlarmNavigation (_bstr_t bstrExportPath ) ; 
virtual ^-CAlarmNavigation { ) ; 



//= 



// public methods 



//= 



H RESULT ManageNavigation( ) ; 



private : 



// private methods 



HRESULT getTargetLanguage ( } ; 
HRESULT getCurrentLanguage ( ) ; 



Quellcode 0.3. : Klassendefinition der Klasse CAlarmNavigation 



10 



Der Einstiegspunkt fur den Export eines Projektes ist die 
Klasse CProj ectNavigation. Pro j ektglobale Daten werden, von 
dieser Klasse ausgehend, exportiert. Das heifit die Klasse CA- 
larmNavigation wird in der Klasse CProj ectNavigation angelegt 
und abgearbeitet . Dafur wird eine neue Funktion getAlarms in 
der Klasse CProj ectNavigation angelegt. Die Funktion Manage- 
Navigation der Klasse CProj ectNavigation muR urn den Aufruf 
der Funktion getAlarms erweitert werden. 
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if ( (m_Export Filter & XM LDATA_ PROJECT EXT ) == XMLDATA_PROJECTEXT ) { 

hr s gpf A 1 r\ rms ( ) ; 

Quell code 0.4. : Funktion ManageNavigation in der Klasse CProjektNavigation 

Die Funktion getAlarms der Klasse CProj ectNavigation erstellt 
einen Link zu der XML- Datei der Alarme. Er zeigt auf die 
XML- Datei, die spater die Alarme enthalt. Uber diesen Link 
ist es moglich vom Projekt auf die Alarme zuzugreifen, was 
fur den Import wichtig ist. Aulierdem mufi die Funktion getA- 
larms eine Instanz der Klasse CAlarmNavigation anlegen und 
dessen ManageNavigation Funktion aufrufen. 
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HRESULT CProj ectNavigat ion : : get Alarms { ) 
{ 

HRESULT hr = S_OK; 

// Create Dom Node ProjecData 

DOM_Element domAlarms ~ m_domDoc . createElement ( " UMC_A1 a rms " ) ; 
m_domRootElement . appendChild (domAlarms ) ; 

setXLink { domAl a rms , _T ( " Al a rms " ) , XLINK_FI LE ) ; 



10 



Quellcode 0.5. : Funktion getAlarms der Klasse CProjektNavigation 

Im Konstruktor der Klasse CAlarmNavigation wird eine neue 
XML- Datei angelegt, die Alarms •xml heilit. Aufierdem wird die 
Membervariable m_bstrDataExportPath gesetzt, die den Pfad der 
Datei angibt . 

Nach dem Durchlaufen des Konstruktors durch das Anlegen einer 
Instanz der Klasse CAlarmNavigation wird nun die Funktion Ma~ 
nageNavigation auf geruf en . 

Diese Funktion tibernimint die Organisation des Exports. Die 
Daten, der Alarme liegen im Basis ES . Es mufi also zuerst ein 
Pointer auf das Interface angefordert werden. Danach werden 
alle relevanten Daten mit Hilfe einzelner Funktionen aus dem 
Basis ES gelesen. 
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HRESULT CAlarmNavigation: : ManageNavigation ( ) 
{ 

HRESULT hr = S_OK; 

hr = getlnterf acePointer ( ) ; 

i f ( FAILED { hr ) ) 
{ 

m_pExport->throw_Error ( get_ResSt ring ( I DS_EX_ERR_NAVALARMS ) ) ; 
return E_FAIL; 

} 

hr = openDomHelper (_T ( "Alarms" )) ; // root Node Name 

hr = getVersion ( ) ; 
if ( FAILED ( hr ) ) 

return E FAIL; 



hr = getCurrentLanguage { ) ; 

if ( FAILED (hr)) 

Quellcode 0.6. : Funktion ManageNavigation der Klasse CAlarmNavigation 

Den Schnittstellenzeiger auf das Interface 

IMC_Alarm_S_Navigate erhalt man nur tiber Umwege . Ausgehend 
vom Projekt wird ein Query Interface auf die Schnittstelle des 
Projektnavigators IMC_ProjectNavigate gemacht. Der Zeiger auf 
diese Schnittstelle enthalt die globalen Objekte, die mit dem 
Aufruf der Funktion getObj ectBylD angesprochen wird. Hier ist 
es nun moglich ein Querylnterface auf das gewiinschte Inter- 
face zu machen und dies einer Membervariable zuzuweisen. 
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HRESULT CAlarmNavigation : : getlnter f acePointer ( ) 



{ 



// get a pointer to the interface of pro j ectnavigation 

CComQIPtr<IMC_Proj ectNavigate, & IID_IMC_Proj ectNavigate> pPN (m_pProj ect ) ; 

i f (pPN == 0) 

return E_FAIL; 

IMC_Ident * pldent = NULL; 
DWORD ret = 0; 

// get a pointer to the interface of the global objects 
// form the pro j ectnavigation 

HRESULT hr = pPN->getObj ectBylD { ESObj ectID_PmGlobCommon, &pldent , &ret ) ; 

i f ( ( FAILED { hr ) ) || (ret !=BUMC_OK)) 
{ 

SafeRelease {pldent ) ; // freigeben 
return E FAIL; 



Quellcode 0.7.: Schnittstellenzeiger fQr die Alarme 



m 



10 



15 



Wenn der Schnittstellenzeiger initialisiert ist, konnen die 
Daten aus dem Basis ES gelesen werden. Fur den Export der A- 
larme sind verschiedene Daten wichtig, wie die Version, die 
CurrentLanguage, die TargetLanguage, die NumberRange und die 
Alarmdaten an sich. 

Die Alarme gliedern sich in verschiedene Sprachen. Das heifit 
zuerst mufi man sich von der Schnittstelle die Liste der Alar- 
me (Funktion getAlarmsList) holen. Dann ist es moglich mit 
Hilfe der Daten eines Alarms (Funktion getAlarm) die ver- 
schiedenen Sprachen eines Alarms (Funktion getLanguageList) 
zu erhalten. Ausgehend von dem Alarm kann man jetzt den Text 
in der zugehorigen Sprache vom Interface erfragen (Funktion 
getAlarmText) • Jede Funktion sollte die Daten, die sie erhal- 
ten hat, in das XML- File schreiben. 
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Der oberste Knoten heiJit Alarm und wird in der Funktion getA- 
larmsList gefilllt. 



lilt 
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HRESULT CAlarmNavigation :: getAlarmsList ( ) 
{ 

HRESULT hr = S_OK; 

long size = 0; 

ESAlarmID * IDlist = NULL; 

// get the list of the alarmlDs 

hr ■* m_pIAlarm->GetAlarmIDList ( &size, &IDlist ) ; 

i f { ( FAILED (hr ) ) || (IDlist == NULL) ) 
{ 

m_pExport-> 

throw_Error (get_ResString (IDS_EX_ERR_ALARM_LIST) ) ; 
return E_FAIL; 

} 

// get the Alarm for each ID in the list 

forfint i - 0; i < size; i++) 

{ 

char string[256] «= {0}; 

// create a new element 

Quell code 0.8. : Funktion getAlarmsList der Klasse CAlarmNavigation 

Wie man in diesem Ausschnitt sehen kann, wird das DOM_Element 
der getAlarm Funktion mit gegeben. Diese Funktion kann somit 
ein DOM_Element unter das ubergebene hangen. AuiJerdem ruft 
die Funktion getAlarm die Funktion getLanguageList auf und 
iibergibt dieser das neue DOM__Element . 

Die Funktion getLanguageList hangt wiederum ein neues 
DOM_Element an das ubergebene. Somit wird DOM- Baum aufge- 
baut, dessen letztes Element der Alarmtext in einer bestimm- 
ten Sprache ist. 
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HRESULT CAlarmNavigation: : getAlarmText (DOM_Element * parentNode, ESAlarmLanguagelD Langua- 

gelD, ESAlarmID dwAlarmID) 

{ 

HRESULT hr = S_OK; 

DWORD ret = 0; 

ComMCAlarmSTextData TextData; 

// get the text of the alarm 

hr = m_pIAlarm->GetRawText (dwAlarmID, LanguagelD, &TextData, iret ) ; 

// connection to the interface was succseeded 

if (SUCCEEDED (hr) ) 

{ 

// can't found the text of the alarm 

if (ret == BUMC_NOT_FOUND) 

{ 

wchar_t buffer (256] = {0}; 
char alarmstring { 256] = {0}; 
char langstring [256] = {0}; 

_ultoa {dwAlarmID, alarmstring, 10) ; 

if (GetLocalelnfo (MAKELCID ( LanguagelD, SORT_DE FAULT ) , 

LOCALE_SLANGUAGE, langstring, 255) — 0 ) 
strcpy ( langstring, ) ; 

_snwprintf {buffer, sizeof (buffer) , 

g e t_Re s S t r i ng ( I DS_EX_WAR_ALARM_TEXT ) , 
m_szAlarmName, langstring) ; 

m_pExport->throw__Error {buffer ) ; 

return E FAIL; 

Quellcode 0.97: Funktion getAlarmText der Klasse CAlarmNavigation 
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Mit diesen Schritten ist es moglich alle Daten der Alarme ei 
nes Projektes zu exportieren. Um die Datei im Internet Ex- 
plorer anzuzeigen, mufi jedoch eine DTD und ein XSL- File vor 
handen sein. Fur die DTD existiert die Funktion writeDTD in 
der Klasse CDomHelper, die iiberschrieben werden muJ3 . Um den 
String der DTD zusammen zusetzten, kann man in der Datei 
DTDObjectDefs.h eine #define anftigen. Die grundlegenden Defi 
nes sind in der Datei DTDHelper .h schon definiert. 
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/////////////////////////////////////////.//////////////////////////////////// 




// Alarms 






// 






fldefine DTD_ALARMS 


\ 




DTD_D(" Alarms" ) 


\ 
\ 


« 


DTD_E ( "Alarms (Version, Cur rent Language, Target Language, IDRange?, " 


\ 


« 


"Alarm* ) " ) 


\ 


« 


DTD_E { "Version ( # PCDATA) " ) 


\ 


« 


DTD_A(" Version GUID CDATA # REQUIRED Major CDATA # IMPLIED " 


\ 


« 


"Minor CDATA ^IMPLIED") 


\ 


« 


DTD_E ( "CurrentLanguage (# PCDATA) " ) 


\ 


« 


DTD_A{ "CurrentLanguage LanguagelD CDATA # REQUIRED " 


\ 


« 


"Name CDATA # REQUIRED" ) 


\ 


« 


DTD_E { "TargetLanguage (# PCDATA) " ) 


\ 


« 


DTD_A( "TargetLanguage LanguagelD CDATA # REQUIRED " 


\ 


Quellcode 0.10.: DTD der Alanne 



Das XSL- File wird auch durch Defines erstellt. Diese Defines 
stehen in der Datei XSLDefs.h und basieren auf Defines der 
XSLDefsHelper.h Datei, 
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///////////////////////////////////////////////////////////////////////////////// 

// ALARMS XSL 

// 

fide fine XSL_ALARMS \ 

\ 

XSL_ALARMS_ LANGUAGE \ 

« XSL_T{ "Alarms", \ 

XSL_HTML_FONT {"Arial Black" , "3" , "Alarms" ) \ 

« " <TABLE STYLE=\"border:lpx solid black\">\n" \ 

« " <TR STYLE=\"font-size:12pt; font-family: Verdana; " \ 

« " font-weight :bold\">\n" \ 

« " <TD>Symbol</TD>\n" \ 
« " <TD STYLE=\"background-color : lightgrey\ ">Language</TD>\n" \ 

« " </TR>\n" \ 

« " <xsl : for-each sel ect=\ "Alarm\ ">\n" \ 

« " <xsl : for-each select=\"Alarmdata\">\n" \ 

« " <TR>\n" \ 

« " <TDXxsl: value-of select=\ "@Symbolname\ "/></TD>\n" \ 

« M <TD STYLE=A"background-color:lightgrey\">\n" \ 



Quellcode 0. 1 1.: XSL- Datei der AJanne 

(w)Der Import 

5 (x) Der SAX- Parser 

Der SAX- Parser ist ein ereignisgesteuerter Parser, der beim 
Auftreffen auf ein XML- Tag in eine Funktion verzweigt. Es 
wird kein XML- Baum im Speicher gehalten, was der Performance 
10 zu Gute kommt. Durch diese Funktionalitat ist dieser Parser 
fur den Import eines Projektes geeignet. 

Urn den SAX- Parsers zu nutzen, sind die Headerdateien des 
Parsers im Projekt eingezogen. Der Parser besteht aus der 
Klasse HandlerBase und besitzt mehrere Funktionen, die von 
15 ihm bei bestimmten Ereignissen aufgerufen werden. Die Funkti- 
onen sind nur definiert und die endgtiltige Implementierung 
wird erst von dem Programmierer in einer abgeleiteten Klasse 
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durchgefuhrt . Damit kann man die Funktionen speziell auf das 
zu losende Problem zuschneiden. Weiterf iihrende Documentation 
dazu ist auf der Seite www . apache . de oder 
www . megginson . com/SAX/ index . html zu f inden . 

In der XML- Software ist die Klasse CSAXHandler von der Klas- 
se HandlerBase abgeleitet. Diese Klasse uberschreibt , wie aus 
dem Code ersichtlich, alle Funktionen der Klasse HandlerBase. 
Wichtig fur die Software sind davon allerdings nur die Funk- 
tionen startElement, endElement, characters und fur die Feh- 
lerausgabe die Funktionen warning, error und FatalError . 
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class CSAXHandler : public HandlerBase, public CImportBase 
{ 

public : 

bool ElementlsNormalTOType (_bstr_t bst rElementName ) ; 
bool ElementlsNormalTO (__bst r_t bst rEl ementName ) ; 
H RESULT GetResultO; 

void SetParseFile (_bstr_t bstrFile); 

bool GetDoValidation { ) { return m_bDoVal idation; } 

//Attributes 

static CParseManager * m_pParseManager ; 
static IsNameMapEntry * m_pTONameMap; 
static long m_lTONameMapSize; 

CSAXHandler ( ) ; 

CSAXHandler (_bstr_t bstrHandlerType ) ; 

CSAXHandler (_bstr_t bstrHandlerType, bool bDoValidation ) ; 
virtual -CSAXHandler () ; 

protected: 

_bstr_t m_bstrParseFile; 
bool m_bErrorOccured; 
_bstr_t m_bstrHandlerType; 
bool m_bDoVal idation; 

publ ic : 

// 

// methods to be overwridden by the derived classes 

// 

virtual void HandleStartElement ( const XMLCh* const name, AttributeList & attributes); 
virtual void HandleEndEleroent (const XMLCh* const name); 

virtual void HandleCharacters { const XMLCh* const chars, const unsigned int length) ; 
_ . Quellcode 0.12.: Klassendefinilion der Klasse CSAXHandler 
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Der Import beginnt in der Klasse CParseManager durch den Auf 
ruf der Funktion ParseProj ect . Hier werden einige Initiali- 
sierungen vorgenommen und der Import des gesamten Projektes 
wird angestoiien. 

Beim Parsen eines Startelementes ruft er SAX- Parser die 
Funktion startElement der Klasse CSAXHandler auf. Die Funkti 
on unterscheidet, ob das Tag ein Link oder ein normales Ele- 
ment ist. 
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Wenn ein Link gefunden wird, stoftt die Funktion das Parsen 
der im Link enthaltenen Datei an. Urn diese Funktionalitat bei 
alien Dateien mit Links zu gewahrleisten, wird fur jede XML- 
5 Datei eine sogenannte „Handlerklasse* erstellt, die von der 
Klasse CSAXHandler abgeleitet ist. 1st das gefundene Tag ein 
Link, wird ein Pointer auf die Handlerklasse initialisiert , 
die diese XML- Datei parsen soil. Danach wird das Parsen der 
Datei durch die Funktion ParseXLinks der Klasse CParseManager 
10 angestoiien. 

Beim Parsen von Elementen mufl man jedoch anders vorgehen. Da- 
* fur stehen die Funktionen HandleStartElement, HandleEndEle- 
^ ment und HandleCharacters zur Verfugung. Sie werden von den 

„Handlerklassen* entsprechend iiberschreiben. Wenn die Funkti- 
15 onen startElement, endElement und characters mit einem Ele- 
ment aufgerufen wird, rufen sie die entsprechende der drei 
Funktionen HandleStartElement , HandleEndElement und Handle- 
Characters auf. 

20 (y) Handeln von Projektkomponenten 

Zum Importieren sollte eine „Handlerklasse* pro zu importie- 
render XML- Datei existieren. Diese Klassen sind von der 
Klasse CSAXHandler abgeleitet und erben somit die Funktiona- 
V^5 litat der Basisklasse . 

Wie beim Export kommt es beim Import auch auf den Inhalt der 
Dateien an. Bei einer Datei, die ausschlieftlich Links ent- 
halt, wird die Funktion startElement der Basisklasse urn IF- 
Abfragen erweitert. Wenn dagegen XML- Files mit Daten geparst 
30 werden sollen, kann man die Klassen wie folgt anlegen. 

Die Klassen mussen die Funktionen HandleStartElement , Hand- 
leEndElement und wenn notig HandleCharacters iiberschreiben. 
Sie werden aufgerufen, wenn der Parser auf ein Start- oder 
Endelement bzw. auf einen Text getroffen ist. Dann ist es 
35 moglich in einer dieser Funktionen abzufragen, welches Tag 
der Parser gefunden hat. Somit kann dort eine Funktion zum 
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Auslesen der Daten aus dem gefundenen Element aufgerufen wer- 
den. Um das Auslesen zu kapseln, sollten die Funktionen in 
einer sogenannten „Makeklasse* definiert werden. Die „Hand- 
lerklasse* besitzt als Membervariable einen Pointer auf die 
„Makeklasse\ die genau die Daten importiert, die das XML- 
File beinhaltet. Der Pointer wird im Konstruktor der „Hand- 
lerklasse* angelegt und im Destruktor freigegeben. Wenn ein 
Element gefunden wurde, das Daten fur den Import enthalt, 
dann wird in einer der drei oben genannten Funktionen eine 
Funktion der Jtfakeklasse* aufgerufen. 



class CAlarmHandler : public CSAXHandler 
{ 

public : 

//Construction/Destruction 

//========= === = == = = = ========================== ^_ ============= _ ======== 

CAlarmHandler { ) ; 

virtual -CAlarmHandler () ; 

/ / ===== _ ============== _ =========== _^ ======== _ =======&============== 

// public methods 

Quellcode 0.13.: Beispiel fiir eine „Handlerklasse" 

(z) Anlegen von Projektkomponenten mit „Makeklassen" 

Um die Daten zu importieren werden die Funktionen einer soge- 
nannten „Makeklasse* aufgerufen. Ein Beispiel fur eine solche 
„Makeklasse* ist im Quellcode 0.17 vorhanden. 

Diese Klassen sind von der Klasse CBasisEsHelper abgeleitet. 
Damit sind alle Member und Funktionen der CBasisEsHelper 
Klasse der ^Makeklasse^ bekannt. Dies ist notwendig da die 
Daten in das Basis ES geschrieben werden mussen. Die Naviga- 
tion zu dem Pointer auf die Schnittstelle, die beim Schreiben 
der Daten angesprochen wird, ist im Kapitel (b) schon fur den 
Export erklart. Auiierdem befinden sich die Schnittstellen zum 
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Schreiben und Lesen meist an dem gleichen Interface. Deswegen 
ist die Dokumentation iiber die 



Y7 
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Navigation zu den gewiinschten Interface nicht nochmals in 
diesem Kapitel enthalten. Der Pointer kann nun in einer Mem- 
bervariable gespeichert werden, da eine Instanz der „Ma- 
5 keklasse* wahrend des Parsens eines XML- Files im Speicher 
bestehen bleibt. 

Die „Makeklassen* benotigen nur Funktionen, die Daten eines 
Tags importieren. Es ist moglich Daten beim Auftreffen auf 
ein Element in das Basis ES zu schreiben oder beim Finden ei- 
10 nes Endtags. Dies ist wichtig, wenn Daten von Elementen, die 
darunter geschachtelt sind, zum Anlegen der Daten im Basis ES 
rf 4 benotigt werden. 

' Somit kann man fur jedes Starttag und Endtag eine eigene 

Funktion definiert werden. Darin werden die Daten der Elemen- 
15 te ausgelesen. Dabei gibt es mehrere Moglichkeiten, wie die 
Daten im Tag eingebunden sind. Wenn sich ein Element aus an- 
deren zusammenset zt , dann sind die Daten in den darunterlie- 
genden enthalten. Jedes Tag kann naturlich auch eigene Daten 
besitzen, die in dessen Attributen gespeichert sind. Die ein- 
20 fachste und herkommlichste Art die Daten eines Elements zu 
speichern, ist jedoch im Text zwischen Start- und Endtag. 
Wenn die Daten aus dem Tag gelesen wurden, konnen sie mit 
Hilfe des Pointers auf die entsprechende Schnittstelle in das 
Basis ES geschrieben werden. Wenn dabei Fehler auftreten, 

A£> sollte auch hier eine Fehlerausgabe erfolgen. 

(aa) Ein Beispiel fur den Import - importieren von Alarmen 

Wie beim Export soil auch an dieser Stelle ein Beispiel das 
in diesem Kapitel Beschriebene verdeutlichen . 
30 Der Import ist ereignisgesteuert und ruft bei einem Ereignis 
(Element) die Funktion startElement der Klasse CSAXHandler 
auf. Hier werden die Links ausgewertet. In diesem Beispiel 
ist das Ereignis „Link auf eine Datei Alarms. xml* wichtig, 
der das Auslesen dieser Datei anstoiit. 
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else if (bstrElementName == _bstr_t (U7DXML_ALARMS ) ) 



Quellcode 0.14.: Importieren des Links auf die Datei Alarms.xml 

Die Variable pEventHandler der CSAXHandler Klasse wird mit 
einem Pointer auf die jeweilige „Handlerklasse* initiali- 
siert. In dem Fall der Alarme ist dies die Klasse CAlarmHand- 
ler. Wenn dieser Pointer initialisiert wurde, kann die Funk- 
tion ParseXlink der Klasse CParseManager aufgerufen werden, 
die dafur sorgt, dass das im Link enthaltene File geparst 
wird. 



if (pEventHandler) 
{ 

// parsing Xlink file with the created parse handler 
^ Quellcode 0.15.: Starten des Parsens eines XML- File 

Wenn die Funktion startElement der Basisklasse CSAXHandler 
jetzt aufgerufen wird, verzweigt diese die Funktion Hand- 
leStartElements . Ebenso wird bei endElement der CSAXHandler 
die Methode HandleEndElements aufgerufen. Die Klasse CAlarm- 
Handler uberschreibt diese Funktionen, so dass dort eine 
spezielle Bearbeitung der XML- Datei umgesetzt werden kann. 
Durch den Pointer auf die „Makeklasse* CMakeAlarm kann auf 
Funktionen zugegriffen werden, die Alarme im Basis ES anle- 
gen. 
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void CAlarmHandler : : HandleStartElement {const XMLCh *const name, AttributeList Sattributes) 
{ 

_bstr_t bstrElementName (name ) ; 

if (bstrElementName == _bstr_t (U7DXML_CURRENT_LANGUAGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAl a rm->setCur rent Language (name, attributes } ; 

} 

else if (bstrElementName _bstr_t (U7DXML_TRAGET_ LANGUAGE ) } 

: { 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAlarm->setTargetLanguage (name, attributes) ; 

} 

else if (bstrElementName == _bstr_t (U7DXML_IDRANGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", { char* ) bstrElementName END 
m_pMakeAlarm->setIDRange (name, attributes ) ; 

} 

else if (bstrElementName == _b s t r_t ( U 1 DXML_ALARM ) ) 

Quellcode 0. 1 6. : Auslesen der Anfangselemente *"* ^ ~ — — _— 

Den eigentlichen Import der Pro j ektdaten ubernimmt die Klasse 
CMakeAlarm. Wenn ein Element im XML- File gefunden wurde, das 
Daten enthalt, die ftir den Import wichtig sind, wird eine 
Funktion der Klasse CMakeAlarm aufgerufen, die diese Daten 
ins Basis ES schreibt. 
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class CMakeAlarm : public CBasisEsHelper 
{ 

public: 

//Const ruction/ Destruction 

CMakeAlarm( ) ; 

virtual -CMakeAlarm () ; 

// public methods 

void setAlarmText (const XMLCh *const name, AttributeList ^attributes) ; 
void endAlarmText { const XMLCh * const name); 

void setLanguage (const XMLCh * const name, AttributeList &attributes ) ; 
void endLanguage (const XMLCh *const name); 

void setAlarmData {const XMLCh *const name, AttributeList &attributes ) ; 
void endAlarmData (const XMLCh * const name); 

Quellcode 0.17.: Importfunktionen fiir Alarme 

In den Methoden der Klasse CMakeAlarm werden die Daten aus 
den XML- Elementen gelesen und uber ein Interface in das Ba- 
sis ES geschrieben. Die Schnittstelle, die das Schreiben der 
Daten ermoglicht, heifit IMC_Alarm_S_Edit und ist uber die 
selben Schnittstellen zu erreichen, wie die beim Export beno- 
tigte Schnittstelle, An diesem Interface werden dann die 
Funktionen zum Schreiben der Alarmdaten aufgerufen. 



Seite 60 von 56 



200023311 



61 



void CMakeAlarm: : setAlarmData {const ^XMLCh *const name, AttributeList &attributes) 

< - _ • ■■ - . ■. : 

HRESULT hr = SJ3K; * ' ■ 

DWORD ret =0; 

ComMCAl armS Data alarmdata; 

// get attributes 

_bstr_t bstrSymbolName = attributes . getValue ( "Symbolname" ) ; 
alarmdata. SymbolName = bstrSymbolName; 

_bstr_t bstrMsgType = attributes . getValue ( "MsgType" ) ; 
alarmdata. MsgType = atoi ({ char* ) bstrMsgType ) ; 

_bstr_t bstrMsgClass = attributes . getValue ( "MsgClass" ) ; 
alarmdata .MsgClass = atoi {{ char* ) bstrMsgClass ) ; 

_bstr_t bstrMsgText = attributes . getValue ( "MsgTextLocked" ) ; 
alarmdata. Msgtextlocked = atoi ({ char* ) bstrMsgText ) ; 

_bstr_t bstrlnfoText = attributes . getValue ( "Inf oTextLocked" ) ; 

Quellcode 0.18.: Schreiben von Daten in das Basis ES 
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Kommunikation mit Step7 



10 



15 



Die dritte und letzte Dll der Export- Import- Software, ist 
fur den Export und Import von den bei SIMOTION SCOUT enthal- 
tenen Step7- Anteilen zustandig. Die Hardwarekonf iguration 
eines Projektes kann mit der Exportf unktion von Step7 expor- 
tiert werden. Fur den Import steht ebenso eine Funktion von 
Step7 zur Verfugung. Die Daten werden im ASCII- Format ge- 
speichert. Deswegen konnen die schon vorhandenen Funktionen 
von Step7 fur den XML- Export- Import verwendet werden. 
Die Schnittstelle, die dafur von AuJien angesprochen werden 
mufl, ist IXMLS7Project . Sie stellt die zwei Funktionen zum 
Export bzw. zum Import der Daten zur Verfiigung. Deswegen hei- 
Ben diese Funktionen Import und Export. 



lUnknown 



IXMLSTPrqject Q)- 



Abbildung 0.1.: Schnittstellen des S7Servers 



20 



Urn bei dem Export und dem Import nicht auf direkt auf das 
Step7 zuzugreifen zu mussen, ubernimmt ein sogenannter Daemon 
diese Aufgaben. Es werden Funktionen des Daemon aufgerufen, 
dieser „ubersetzt* die Aufrufe und fuhrt die entsprechenden 
Aktionen bei Step7 durch. 
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Abbildung 0.2. : Daemon des Step7 Export- Import 



Der Export sowie der Import der Step7- Projekte werden in der 
Klasse CXMLS7Proj ect durchgef uhrt . 

Fur den Export wird in dieser Klasse die Funktion Export auf- 
gerufen. Hier werden die Funktionen OpenProjectS7, ChooseRe- 
levantStatlons, ExportRelevantStations und CloseProj ektsS7 
auf gerufen. Damit wird zuerst das zu exportierende Projekt 
und die darin enthaltenen Stationen ausgewahlt. Dann werden 
die Stationen durch ExportRelevantStatlons exportiert. Das 
Schlieflen des Projektes wird mit Hilfe der Methode ClosePro- 
jektsS7 ermoglicht. 

Beim Importieren wird die Funktion Import auf gerufen. Das 
Offnen und Schlieiien des Step7- Projektes iibernehmen auch 
hier die Funktionen OpenProj ectS7 und ClosePro- 
jektsS7. Weiterhin werden die Funktionen GetCurrentS7Handle, 
CompareStationNames und ImportOneStation verwendet. Die Me- 
thode Compares tationNames wird benotigt, urn das Importieren 
einer schon im Projekt vorhandenen Station zu verhindern. 
Wenn Stationen importiert werden sollen, mufi die Methode Im- 
portOneStation fur die zu importierende Station aufgerufen 
werden. 
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Das Format und die Hierarchie der exportierten Daten 



Ein exportiertes SIMOTION SCOUT- Projekt wird in einer Ord- 
5 nerstruktur abgelegt. Diese Struktur ist angelehnt an den 
Aufbau eines Projektes im SIMOTION SCOUT- Pro j ektnavigator . 



UMC - Projekt 



Pto&rX Bearberten t^Uacn Zif>b^(em A/isich* Extras Fer*ster Hlite 
||j<KeinFilter> j Filte? Bttum^ | : 



I 



llliliffllffil 



> © Projekl 

I r ~/t\ Hardware konfigurieren 
i=l fia Device 

!■ 4J ABLAUFSYSTEM 

| a-^jACHSEN 

r -/t^ NeueAchseeinrugen 
! £ -0 Po$kiniefungsachse 
$Hl NOCKEN 
i - > Benufcerdaten 

^•Qj messtaster 

j .&NeuenMe«teaereWugen 
S> '^S Messtaster 

••• y ^Configuration 
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Sie arbeiten im Offline-Modus ! 



Abbildung 0.1.: Aufbau eines Projektes im Proj ektnavigator 
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Die grofie Menge der Daten eines Projektes wird in geglieder- 
ten Datenblocken gespeichert. Damit wird eine iibersichtliche 
Datenhaltung moglich gemacht, die dem Benutzer nach dem Ex- 
port immer noch logisch erscheint. Ein anderer Gesichtspunkt 
fur eine solche Hierarchie, ist die Moglichkeit, Komponenten 
eines Projektes zu analysieren oder liber das Internet zu ver- 
schicken, ohne das unwichtige Daten storen. 
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(bb) Die Hierarchie der exportierten Daten eines SIMOTION SCOUT- Projek- 
tes 

Qrdner : MyPro j ectDataFolder 
Projekt .xml 
Qrdner: Projekt 
Pro j ekt . xml 
Alarms . xml 
Installation . xml 
Ref erenceTable . xml 
S7ProjectData .xml 
Qrdner: Device 
Device .xml 
RunTimeLevels .xml 
DeviceData .xml 
Device_Symbols . xml 
Qrdner : ProcessingUnit 
ProcessingUnit .xml 
SCL-Programm . xml 
Qrdner: TOCamType 
TOCamType .xml 
Kurvenscheibe . xml 
Qrdner: TOPosAxis 
TOPosAxis .xml 

Qrdner : Positionierungsachse 
Positionierungsachse .xml 
ExpertList . xml 

3 0 (cc) Erlauterung zu den exportierten Dateien 

In der Hierarchie werden unterschiedliche XML- Dateien ange- 
legt. Dateien konnen ausschlieBlich Links enthalten oder aus- 
schlieiilich Daten. Die Dateien, die Links enthalten, liegen 
35 in einem gleichnamigen Ordner und sind die Dateien, durch die 
der Einstieg in diesen Ordner ermoglicht wird. Die Links, die 
in den Dateien enthalten sind, verweisen auf XML- Dateien, 
die fur die Datenhaltung zustandig sind und im gleichen Ord- 
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ner liegen. AuJierdem konnen die Links auch auf die Einstiegs- 
dateien der Unterordner zeigen. Durch dieses Prinzip wird die 
Portierbarkeit vereinfacht. Das heiftt es ist gewahrleistet , 
einen Ordner aus der Hierarchie zu nehmen, ohne das die 
5 Struktur verloren geht . Somit konnen relevante Daten an Drit- 
te weiter gegeben werden ohne unnutze Dateien mit zuliefern. 

Ordner : MyPro j ectDataFolder - Der Ordner enthalt das ge- 
samte exportierte Projekt mit alien XML- 
10 Dokumenten, XSL- Dateien, HTML- Sei- 

ten und gegebenenf alls Unterordnern, 
die alle Daten des Projektes mit 
"^P' dessen speziellen Eigenschaf ten im 

XML- Format beschreiben. Der Name 
15 dieses Ordners wird durch den Benut- 

zer gewahlt (siehe Kapitel (g) ) 
Zu diesem Ordner existiert eine XML- 
Datei, die das Projekt im ganzen 
verlinkt und die in diesem Fall Pro- 
20 jekt.xml heifit. 

Projekt. xml - Diese Datei beinhaltet alle 

Links zu den XML- Dateien, welche die 

Projektdaten genauer spezif izieren, 
: ^j| 5 wie z u Beispiel die einzelnen Devi- 

ces des Projektes. 
Ordner: Projekt - Durch diesen Ordner werden 

die proj ektglobalen Daten gekapselt. 

30 Pro jekt.xml - Diese „Linkdatei* verweist auf 

die Devices und alle XML- Datei, 

die projektglobale Daten enthalten. 
Alarms. xml - Zum Speichern der Alarmdaten 

eines SIMOTION SCOUT- 
35 Projektes ist diese Datei entstan- 

den . 
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Installation. xml - In dieser Datei sind Kom- 

ponenten von SIMOTION SCOUT 

beschrieben, die beim Zeitpunkt des 
Exports installiert waren. 
ReferenceTable.xml - Diese Datei enthalt alle Refe- 

renzen und Verweise, die einzelne 
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Teilkomponenten untereinander besit- 
zen. Damit nach dem Import die Funk- 
tionalitat der Objekte wieder vor- 
5 handen ist, wird diese Datei ausge- 

wertet . 

S7Pro j ectData . xml - Die Hardwarekonf iguration der Step7- 

Anteile wird in der 

Datei beschrieben. 
10 Ordner: Device - In diesem Ordner sind alle XML- Do- 

kumente, XSL- Files, HTML- 

Seiten und Unterordner enthalten, 
die Einzelheiten eines Device bein- 
halten. Da ein Projekt aus mehren 
15 Devices aufgebaut sein kann, das.s 

iuehrere Ordner dieser Art vorhanden 
sind. 

Auch in diesem Ordner wurde eine 
XML- Datei erstellt, die dieses De- 
20 vice im XML- Format beschreibt. 

Device. xml - Wie oben erklart, verwaltet diese 

Datei Links zu anderen 

untergeordneten XML- Dateien. 
RunTimeLevels .xml - In der Datei stehen 

die Tasks, die von dieser Device bearbeitet 

werden konnen. 

DeviceData .xml - Diese Datei beinhaltet die Ei- 

genschaften eines Device. 
30 Devi ce_Symbols .xml - Hier werden die Symbole und Va- 

riablen eines Device gespeichert, 
wie z.B. 10- Variablen. 
Ordner : ProcessinqUnit - Dieser Ordner enthalt alle 

Programme, die in die CPU geladen 
35 werden konnen und ausgeftihrt werden 

konnen. 
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ProcessingUnit . xml - Diese Datei enthalt alle Links 

auf die erstellten Programme. 

SCL-Programm. xml - In dieser Datei wird ein Pro- 

gramm (MCC- Programm oder St- 

Programm) beschrieben . 
Ordner: TOCamType - Der Ordner enthalt fur die Kur- 

venscheiben spezifische Daten. 

TOCamType. xml - Alle Links auf die im Projekt ent- 

haltenen Kurvenscheiben sind in 

dieser Datei enthalten. 
Kurvenscheibe .xml - Hier werden die Daten einer 

Kurvenscheibe gespeichert . 

Ordner: TOPosAxis - Dieser Order enthalt alle Daten 

der Positionierungsachsen. Alle 

anderen Objekte, die in einer Stati- 
on enthalten sein konnen, werden in 
einer ahnlichen Hierarchie hinter- 
legt, dabei macht eine Kurvenscheibe 
eine Ausnahme. So werden zum Bei- 
spiel alle Messtaster einer Station 
in einem Ordner namens „TOMeasurin- 
glnputType* gespeichert. Dieser Ord- 
ner beinhaltet eine gleichnamige 
XML- Datei die Links zu jeder XML- 
Datei eines einzelnen Messtasters. 
Diese XML- Files tragen den Namen 
des Messtasters und liegen in einem 
gleichnamigen Unterordner des „TO- 
MeasuringlnputType*- Ordners . In 
diesem Ordner ist aufterdem die Ex- 
pertenliste des Messtasters im XML- 
Format gespeichert . 

TOPosAxis .xml - Die Datei bein- 

haltet Links zu den einzelnen Positionierungsachsen 
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Qrdner : Positionierungsachse - Dieser Ordner enthalt 

alle Daten einer Positionierungsachse 

Positionierungsachse .xml - Diese „Linkdatei* zeigt 

auf die „Datendatei* der Positionierachse . 

ExpertList .xml - Die Expertenliste der Positio- 

nierungsachse ist in der Datei 

hinterlegt . 
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Patentanspruche 

1. Verfahren zur Ablage und zur Bearbeitung von Projekt- 
und/oder Pro j ektierungsdaten einer Automatisierungskompo- 

5 nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

Bereitstellung von Projektdaten einer Automat isierungskom- 
ponente auf Basis XML, 

Export/ Import von Projektdaten in XML und 
10 - Verarbeitung der XML-Daten mit Standardwerkzeugen . 

2. Verfahren nach Anspruch 1, 

dadurch gekennzeichnet, dass als Standardwerzeuge eine Unter- 
menge von 
15 - Versionsverwaltungstools 
Externe CAD-Programme 
Externe Kurvenscheibenwerkzeuge 
Externe Productivity Tools 
Externe Skripting Mechanismen 
2 0 verwendet wird. 

3. System zur Ablage und zur Bearbeitung von Projekt- 
und/oder Pro j ektierungsdaten einer Automatisierungskompo- 
nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

Bereitstellung von Projektdaten einer Automatisierungskom- 
ponente auf Basis XML, 

- Export/ Import von Projektdaten in XML und 

- Verarbeitung der XML-Daten mit Standardwerkzeugen. 

30 

4. System nach Anspruch 3, 

dadurch gekennzeichnet, dass als Standardwerzeuge eine Unter- 
menge von 

- Versionsverwaltungstools 
35 - Externe CAD-Programme 

Externe Kurvenscheibenwerkzeuge 
Externe Productivity Tools 
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Externe Skripting Mechanismen 
verwendet wird. 
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